<html>
	<head>
		<title>P4Eclipse Integration</title>
		<link rel="STYLESHEET" href="book.css" charset="ISO-8859-1" type="text/css">
	<head>
	<body>
		<h2>Eclipse Integration</h2>
		
		<p>
			The p4eclipse plugin integrates closely with Eclipse to provide a clear 
			view of which files are under perforce control and which are not.
			Files that are not under perforce control can easily be added, and just 
			as easily be marked so that perforce, and the plugin, will ignore them.
		</p>
		
		<h3>
			<a name="ProblemMarkers">Problem Markers</a>
		</h3>
			
			<p>
				P4Eclipse will automatically mark files in a perforce controlled project
				that do not have a counterpart in the depot as 
				<b>Local addition not under Perforce control</b> in the Eclipse
				<span class="viewTitle">Problems</span> view.
			</p>
			<p>
				Apart from filtering out the perforce problem markers in the filters setup
				of the <span class="viewTitle">Problems</span> view, by deselecting
				<span class="menu">Perforce&nbsp;Add</span> from the 
				<span class="menu">Show&nbsp;items&nbsp;of&nbsp;type</span> list, p4eclipse 
				also allows for two <b>Quick Fix</b> methods to handle the problems.
				<h4>Quick Fix</h4>
					<h5>Add file to source control</h5>
					<p>
						One solution can be to add the local file to the depot. The result is
						the same as <a href="PerforceOperations.html#AddToSourceControl">adding 
						the file to source control</a> manually.
					</p>
					<h5>Add to .p4ignore</h5>
					<p>
						Another option is to add the file to the .p4ignore file that perforce
						uses to mark files that are not supposed to be under its control.
					</p>
					<p>
						This can be done by simply adding the specific file to the .p4ignore file, by 							using the <span class="menu">Add&nbsp;to&nbsp;.p4ignore</span> Quick Fix. A
						more generic approach is also possible, allowing you to add the file's entire
						containing directory to the .p4ignore file with
						<!-- TODO: what is this entry really called? -->
						<span class="menu">Add parent to .p4ignore</span>, or even to add a 
						selection pattern, such as &quot;*.log&quot; to add all .log files in the project
						directories,  to the .p4ignore file for more complex situations with 
						<span class="menu">Add pattern to .p4ignore</span>. The patterns are normal
						file selection patterns, using '?' and '*' as wildcards.
					</p>
					
		<h3>
			<a name="LabelDecorators">Label Decorators</a>
		</h3>
			
			<p>
				P4Eclipse can mark the files in your workspace as being under perforce control if
				you enable this function in the <a href="Preferences.html#LabelDecorators">
				preferences</a>.
			</p>
			<h4>Open files ('&gt;' and '*')</h4>
			<p>
				Files that are opened for your client view are marked with either a <b>&gt;</b>,
				indicating an existing file that has been 
				<a href="PerforceOperations.html#OpenForEdit">opened for edit</a>, or with a 
				<b>*</b>, indicating a file that has been newly 
				<a href="PerforceOperations.html#AddToSourceControl">added to source control</a>.
			</p>
	</body>
</html